package net.sourceforge.filebot.mediainfo;


import static java.util.Collections.singletonMap;

import java.lang.reflect.Method;

import com.sun.jna.FunctionMapper;
import com.sun.jna.Library;
import com.sun.jna.Native;
import com.sun.jna.NativeLibrary;
import com.sun.jna.Pointer;
import com.sun.jna.WString;


interface MediaInfoLibrary extends Library {
        
        MediaInfoLibrary INSTANCE = (MediaInfoLibrary) Native.loadLibrary("mediainfo", MediaInfoLibrary.class, singletonMap(OPTION_FUNCTION_MAPPER, new FunctionMapper() {
                
                @Override
                public String getFunctionName(NativeLibrary lib, Method method) {
                        // MediaInfo_New(), MediaInfo_Open() ...
                        return "MediaInfo_" + method.getName();
                }
        }));
        
        
        /**
         * Create a new handle.
         * 
         * @return handle
         */
        Pointer New();
        

        /**
         * Open a file and collect information about it (technical information and tags).
         * 
         * @param handle
         * @param file full name of the file to open
         * @return 1 if file was opened, 0 if file was not not opened
         */
        int Open(Pointer handle, WString file);
        

        /**
         * Configure or get information about MediaInfo.
         * 
         * @param handle
         * @param option The name of option
         * @param value The value of option
         * @return Depends on the option: by default "" (nothing) means No, other means Yes
         */
        WString Option(Pointer handle, WString option, WString value);
        

        /**
         * Get all details about a file.
         * 
         * @param handle
         * @return All details about a file in one string
         */
        WString Inform(Pointer handle);
        

        /**
         * Get a piece of information about a file (parameter is a string).
         * 
         * @param handle
         * @param streamKind Kind of stream (general, video, audio...)
         * @param streamNumber Stream number in Kind of stream (first, second...)
         * @param parameter Parameter you are looking for in the stream (Codec, width, bitrate...),
         *            in string format ("Codec", "Width"...)
         * @param infoKind Kind of information you want about the parameter (the text, the measure,
         *            the help...)
         * @param searchKind Where to look for the parameter
         * @return a string about information you search, an empty string if there is a problem
         */
        WString Get(Pointer handle, int streamKind, int streamNumber, WString parameter, int infoKind, int searchKind);
        

        /**
         * Get a piece of information about a file (parameter is an integer).
         * 
         * @param handle
         * @param streamKind Kind of stream (general, video, audio...)
         * @param streamNumber Stream number in Kind of stream (first, second...)
         * @param parameter Parameter you are looking for in the stream (Codec, width, bitrate...),
         *            in integer format (first parameter, second parameter...)
         * @param infoKind Kind of information you want about the parameter (the text, the measure,
         *            the help...)
         * @return a string about information you search, an empty string if there is a problem
         */
        WString GetI(Pointer handle, int streamKind, int streamNumber, int parameterIndex, int infoKind);
        

        /**
         * Count of streams of a stream kind (StreamNumber not filled), or count of piece of
         * information in this stream.
         * 
         * @param handle
         * @param streamKind Kind of stream (general, video, audio...)
         * @param streamNumber Stream number in this kind of stream (first, second...)
         * @return number of streams of the given stream kind
         */
        int Count_Get(Pointer handle, int streamKind, int streamNumber);
        

        /**
         * Close a file opened before with Open().
         * 
         * @param handle
         */
        void Close(Pointer handle);
        

        /**
         * Dispose of a handle created with New().
         * 
         * @param handle
         */
        void Delete(Pointer handle);
        
}